home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games Extra 1996 June / Amiga Games Extra 1996 #6.iso / userbox / publicdomain / svoutahrle / utahrle.doc < prev    next >
Text File  |  1995-12-16  |  4KB  |  136 lines

  1.  
  2.   UtahRLE.svobject
  3.  
  4.   written and (in parts) © 1995 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 3.3
  9.   Release Date : 16.12.1995
  10.  
  11.  
  12.   Requirements
  13.   ~~~~~~~~~~~~
  14.   - OS V2.04+ (V37)+ and its libraries
  15.   - 68020+
  16.   - superview.library V11+
  17.   - superviewsupport.library V6+
  18.   - mathffp.library V33+
  19.  
  20.  
  21.   Description
  22.   ~~~~~~~~~~~
  23.   UtahRLE.svobject is an external Library-Module for the
  24.   superview.library V11+.
  25.  
  26.   It needs any SVDriver with 24 Bit ChunkyPixel-Support.
  27.  
  28.   It supports reading and writing of UtahRLE (RayTracer) Files.
  29.   In detail these are :
  30.  
  31.   Reading :
  32.  
  33.    - Utah RLE 24 Bit
  34.  
  35.   Writing :
  36.  
  37.    - Utah RLE 24 Bit
  38.  
  39.   Remarks
  40.   ~~~~~~~
  41.    - only 24 Bit sources will be written as Utah RLE
  42.      There's no conversion done from e.g. 256 Colors to 24 Bit
  43.      to perform the requirements of this file format.
  44.    - while writing Utah RLE 24 Bit files, the machine will
  45.      "deadlock" for a short time, which looks like it has been
  46.      crashed silently, but it will be back soon.
  47.      DON'T RESET, since this might affect your harddisk, as usual.
  48.    - don't know, whether the Utah URT routines are re-entrant
  49.      and might be used by more than one program at the same time
  50.  
  51.  
  52.   Legal Issues
  53.   ~~~~~~~~~~~~
  54.   This program is FREEWARE.
  55.   The author does not claim any copyrights on the code, which is
  56.   used to read and write the UtahRLE-file (see credits)
  57.  
  58.   Copyright is only claimed for the program as a whole, which means
  59.   that some parts of the library module, which are also used within
  60.   other SVObjects, are copyrighted by the author.
  61.  
  62.  
  63.   Credits
  64.   ~~~~~~~
  65.   This program uses the "rle.lib" which contains routines from
  66.  
  67.                        THE UTAH RASTER TOOLKIT
  68.  
  69.   These routines have in this case been taken from a distribution of
  70.   the RayShade Raytracer (4.0.6.3) and have been recompiled for
  71.   68030 systems under use of SAS/C V6.56.
  72.   Due to the distribution conditions of the URT kit I felt it would
  73.   be most appropriate to include the full source code of this
  74.   SVObject as well as those parts of the URT kit, which have been
  75.   used. Only some additional example programs, which had been added
  76.   by the authors of the Rayshade Raytracer are actually missing
  77.   (I don't know, whether there are more sources available).
  78.  
  79.   For more information please refer to "source/URT/blurb.urt"
  80.   and the single sourcecode files.
  81.  
  82.  
  83.   Some words to the implementation:
  84.   To find out, how to implement the URT support itself I consulted
  85.   the sourcecodes which have been supplied with the RayShade Raytracer,
  86.   the FBM package and the JFIF-JPEG routines.
  87.   No source codes from there have been needed, but these really
  88.   helped a lot in finding out, how it actually works.
  89.  
  90.  
  91.   Author
  92.   ~~~~~~
  93.   Andreas_Kleinert@superview.ftn.sub.org
  94.   Fido 2:2457/435.10
  95.  
  96.  
  97.   History
  98.   ~~~~~~~
  99.   V3.3 (16.12.1995) :
  100.  
  101.    - added new, rock-solid startup code
  102.    - replaced IEEE with FFP support (due to crashes)
  103.    - no longer causes crashes
  104.    - using new GST
  105.    - updated sources and so on coming with the distribution
  106.      (might have included older ones with some of the former releases)
  107.  
  108.   V3.2 (24.10.1995) :
  109.  
  110.    - recompiled with SAS/C V6.56
  111.  
  112.   V3.1 (07.10.1995) :
  113.  
  114.    - updated to V3 specs
  115.  
  116.   V2.3 (29.7.1995) :
  117.  
  118.    - reworked to close files immidiately after reading/writing - if successful
  119.    - requests superviewsupport.library V5+ now
  120.    - enabled immediate SVDriver switching
  121.    - fixed generation of ViewModes (important for 24 Bit and 8 Bit with ECS)
  122.  
  123.   V2.2 (14.4.1995) :
  124.  
  125.    - now saves A1 when opened/closed
  126.  
  127.   V2.1 (14.4.1995) :
  128.  
  129.    - first version, compiled iwth SAS/C V6.55
  130.  
  131.  
  132.   Copyrights
  133.   ~~~~~~~~~~
  134.   Some of the mentioned names or products above are be copyrighted by
  135.   companies or trademarks of companies.
  136.